GETTTYENT
Section: C Library Functions (3)
Updated: May 20, 1986
Index
Return to Main Contents
NAME
getttyent, getttynam, setttyent, endttyent - get ttys file entry
SYNOPSIS
#include <ttyent.h>
struct ttyent *getttyent()
struct ttyent *getttynam(name)
char *name;
setttyent()
endttyent()
DESCRIPTION
Getttyent,
and
getttynam
each return a pointer to an object with the
following structure
containing the broken-out
fields of a line from the tty description file.
-
man2html: unable to open or read file
/NextDeveloper/Headers/bsd/ttyent.h
- ty_name
-
is the name of the character-special file in the directory ``/dev".
For various reasons, it must reside in the directory ``/dev".
- ty_getty
-
is the command (usually
getty(8))
which is invoked by
init
to initialize tty line characteristics.
In fact, any arbitrary command can be used;
a typical use is to initiate a terminal emulator in a window system.
- ty_type
-
is the name of the default terminal type connected to this tty line. This
is typically a name from the
termcap(5)
data base.
The environment variable `TERM' is initialized with this name by
getty(8)
or
login(1).
- ty_status
-
is a mask of bit fields which indicate various actions to be allowed on this
tty line. The following is a description of each flag.
-
- TTY_ON
-
Enables logins (i.e.,
init(8)
will start the specified ``getty" command
on this entry).
- TTY_SECURE
-
Allows root to login on this terminal. Note that `TTY_ON' must be included
for this to be useful.
- ty_window
-
is the command to execute for a window system
associated with the line. The window system will be started before
the command specified in the
ty_getty
entry is executed.
If none is specified, this will be null.
- ty_comment
-
is the trailing comment field, if any; a leading delimiter and white space
will be removed.
Getttyent
reads the next
line from the ttys file, opening the file if necessary;
setttyent
rewinds the file;
endttyent
closes it.
Getttynam
searches from the beginning of the file until a matching
name
is found
(or until EOF is encountered).
FILES
/etc/ttys
SEE ALSO
login(1), ttyslot(3), ttys(5), gettytab(5), termcap(5), getty(8), init(8)
DIAGNOSTICS
Null pointer
(0) returned on EOF or error.
BUGS
All information
is contained in a static area
so it must be copied if it is
to be saved.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- FILES
-
- SEE ALSO
-
- DIAGNOSTICS
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 17:21:29 GMT, March 25, 2025